Skip to content

docs: add ADR for Docker Image Variant v2 - #221

Merged
Soner (shyim) merged 2 commits into
mainfrom
adr/docker-image-variant-v2
Jul 27, 2026
Merged

docs: add ADR for Docker Image Variant v2#221
Soner (shyim) merged 2 commits into
mainfrom
adr/docker-image-variant-v2

Conversation

@shyim

Copy link
Copy Markdown
Member

Architecture Decision Record proposing:

  • Calendar-versioned, immutable image tags (-vYYYY.N suffix) so breaking changes don't silently roll out
  • Debian-based production images to replace Alpine and avoid musl issues
  • Reduced image matrix from 8 variants to 4
  • Formal support policy with deprecation windows

See also shopware/docker#150.

Proposes calendar-versioned immutable tags, Debian-based images,
reduced matrix, and a formal support policy.
Comment thread adr/2026-07-08-docker-image-variant-v2.md
Comment thread adr/2026-07-08-docker-image-variant-v2.md
Comment thread adr/2026-07-08-docker-image-variant-v2.md
@kevinrudde

Copy link
Copy Markdown
Member

I'm happy to contribute if you need help, I have built some php base images in the past for the SBP components as well 😃

Comment thread adr/2026-07-08-docker-image-variant-v2.md
Comment thread adr/2026-07-08-docker-image-variant-v2.md
Comment thread adr/2026-07-08-docker-image-variant-v2.md
- rename section 1 to reflect contract-frozen (not bit-immutable) tags
- document rolling-tag flip as the breaking-change event
- require otel/grpc extensions installed but not loaded by default
- state dev images are rebuilt on the FrankenPHP variant
- add emergency exception to the one-version-per-year rule
- flag ONBUILD reliability under BuildKit as verify-before-GA
- call out v1 entrypoint change for the deprecation notice
@shyim
Soner (shyim) merged commit 63b570f into main Jul 27, 2026
13 checks passed
@shyim
Soner (shyim) deleted the adr/docker-image-variant-v2 branch July 27, 2026 07:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

7 participants